home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / utimes.z / utimes
Encoding:
Text File  |  2002-10-03  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. UUUUTTTTIIIIMMMMEEEESSSS((((3333BBBB))))                                                          UUUUTTTTIIIIMMMMEEEESSSS((((3333BBBB))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      utimes - set file times
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttiiiimmmmeeee....hhhh>>>>
  13.  
  14.      uuuuttttiiiimmmmeeeessss((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ffffiiiilllleeee,,,, ccccoooonnnnsssstttt ssssttttrrrruuuucccctttt ttttiiiimmmmeeeevvvvaaaallll ttttvvvvpppp[[[[2222]]]]))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _u_t_i_m_e_s call uses the "accessed" and "updated" times in that order
  18.      from the _t_v_p vector to set the corresponding recorded times for _f_i_l_e.
  19.  
  20.      The caller must be the owner of the file or the super-user.  The "inode-
  21.      changed" time of the file is set to the current time.
  22.  
  23.      This routine emulates the 4.3BSD _u_t_i_m_e_s system call.
  24.  
  25. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  26.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  27.      of -1 is returned and _e_r_r_n_o is set to indicate the error.  _U_t_i_m_e_s will
  28.      fail if one or more of the following are true:
  29.  
  30.      [ENOTDIR]   A component of the path prefix is not a directory.
  31.  
  32.      [EINVAL]    The pathname contains a character with the high-order bit
  33.                  set.
  34.  
  35.      [ENAMETOOLONG]
  36.                  A component of a pathname exceeded 255 characters, or an
  37.                  entire path name exceeded 1023 characters.
  38.  
  39.      [ENOENT]    The named file does not exist.
  40.  
  41.      [ELOOP]     Too many symbolic links were encountered in translating the
  42.                  pathname.
  43.  
  44.      [EPERM]     The process is not super-user and not the owner of the file.
  45.  
  46.      [EACCES]    Search permission is denied for a component of the path
  47.                  prefix.
  48.  
  49.      [EROFS]     The file system containing the file is mounted read-only.
  50.  
  51.      [EFAULT]    _F_i_l_e or _t_v_p points outside the process's allocated address
  52.                  space.
  53.  
  54.      [EIO]       An I/O error occurred while reading or writing the affected
  55.                  inode.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. UUUUTTTTIIIIMMMMEEEESSSS((((3333BBBB))))                                                          UUUUTTTTIIIIMMMMEEEESSSS((((3333BBBB))))
  71.  
  72.  
  73.  
  74. _NNNN_OOOO_TTTT_EEEE_SSSS
  75.      Note that prior to IRIX 6.5.10 the _u_t_i_m_e_s() call only offered second
  76.      resolution because it used the _u_t_i_m_e() call internally to execute its
  77.      functionality. _u_t_i_m_e_s() now uses the new _u_t_i_m_e_t_s() call to execute its
  78.      functionality and thus now can offer the microsecond accuracy it
  79.      promises.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      _ssss_tttt_aaaa_tttt(2), _uuuu_tttt_iiii_mmmm_eeee(2), _uuuu_tttt_iiii_mmmm_eeee_tttt_ssss(2)
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.